home *** CD-ROM | disk | FTP | other *** search
/ HPAVC / HPAVC CD-ROM.iso / $GSPPX11.ZIP / PPLX.DOC < prev    next >
Text File  |  1995-06-02  |  12KB  |  302 lines
  1.            ▄▄▄▄▄▄                        ▄
  2.          ▄█▀▀██████▄                             ▄
  3.          █    ██████▀ ▄▄█████████████▀  ▄▄▄▄▄▄▄▄▄▄ ▀▄█ ▄     ▄▄▄▄▄▄▄▄▄
  4.          ░▀  ▐██▀██ ▄██▀▀▀      ▀█▀ ▄▄█████████████▄ ████▄ ▄███████████▄
  5.           ░  ██▌ ▐█ ██           ░ ██▀▀ ▄▄▄▄▄▄▄▄▄ ▀█ █ ▄ ▄ █▀        ▄ █
  6.              ██   █ ▀█            ██▀ █▀         ▀▄▄ ▄▄██▀ █▄         ▀▌ ▄
  7.             ▐█▌   ▐█ █ ▄▄▄▄█▄▄▄▄▄ ██ █             ▀▄ ▀██ ▀████████▄
  8.             ██     █ █▄ ▀░     ▀█ ██▄ █       ▄▀▀▄   █ ███ ░▀▀▀▀▀▀▀▀▓▓▄
  9.             ██  ▄  █ ▀█▄        ░  ██ ▀▄      ░  ▀▄  █ ███           ▀██
  10.            ▐█ ▄███▄ █ ▀█▄           ██▄ ▀▄▄▄▄▄  ▄▄▀ ██ ███  ▄        ▄██
  11.    ▄▄      █▄ ░    ▄██ ▀██▄▄ ▄  ▄▄█▄ ▀██▄▄▄▄▄ ▀▀ ▄▄███ ██ ▄█ ▀    ▄▄▓▓█  ▀
  12.   █  ▀   ▄██       ░▀▀█▄ ▀▀██████████▄ ██████████████ ▄██ ███████████▀ ░
  13.   ▌▀▄▄▄██▀▀ ░ kP<aRT>░▀███▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄ ▄▄ ▄ ▄  ▄   ▄
  14.   ▌
  15.                        ▀            ▀   ▀ ▄ ▄▀ ▀▄█ █▀▀ █▀▒ █▀▒ █▀▒
  16.                              ▄   ▀    ▀ ▄  ▀ ▄▀▄ █ ▓▄▄ ▓▄█ ▓▀▄ ▓▀▀
  17.  
  18.                       ·   · ·-─────────────────--· ·   ·
  19.                                 P.P.L.X - 1.O1
  20.                       ·   · ·-─────────────────--· ·   ·
  21.                      PCBoard Programming Langage eXtractor
  22.                              (C) 1995 Lone Runner
  23.  
  24.  
  25.  
  26.                            Main Coding - Lone Runner
  27.                                  Parts - The doC
  28.  
  29.  
  30.  
  31.  
  32.   ─────────────────────--· ·   ·
  33.   ■ READ BEFORE USING !
  34.   ─────────────────────--· ·   ·
  35.  
  36.     You may use this program provided that :
  37.  
  38.     - You are not part of any federal group (i don't like federal groups ;))
  39.     - You are not part of Clark Development Company (nothing personnal...)
  40.     - You planed to use it at home for personnal purposes only (no money here!)
  41.  
  42.     THE AUTHOR MAY NOT BE RESPONSIBLE FOR ANY CHANGE MADE TO ANY PROGRAM
  43.     BY USING PPLX. Nobody will ever ever enter an action against Borland
  44.     because they made Turbo Debugger or to V Communication because they
  45.     made Sourcer. There is no more reason for PPLX author to be responsible
  46.     for any law violation by using this software.
  47.  
  48.     If you don't agree with the above terms or if you are not in accordance
  49.     with restriction use, you HAVE to delete this software IMMEDIATLY.
  50.  
  51.     Further use of this software will be consider as the acceptance of the
  52.     above terms.
  53.  
  54.  
  55.  
  56.  
  57.   ─────────────--· ·   ·
  58.   ■ DESCRIPTION
  59.   ─────────────--· ·   ·
  60.  
  61.   PPLX is a PPE decompiler... working with PPE's up to 3.10 and, handling
  62.   FUNCTIONS & PROCEDURES. (yes!! ;))
  63.  
  64.  
  65.   1.O1 follows 1.OO and corrects a small bug that prevent PPLX from
  66.   decompiling some PPE's in very special circumstances (actually, i only
  67.   saw this happen one time ;))
  68.  
  69.   v1.OO followed v1.OOß1 and corrected a number of bugs/mistakes/changes...
  70.   Previous version (beta) was decompiling about 80% of PPE's 2.O & 3.x 
  71.   (and almost NO PPE v1.O ;)) This version decompile 100% of my PPE collection
  72.   (227 files). Some does not recompile due to unused functions, but they only
  73.   need 2/3 changes to be recompilable. I don't think that 100% of the PPE's
  74.   you will try to decompile will work, but i tested enough to evaluate the
  75.   percentage of success to more that 99%.
  76.  
  77.  
  78.  
  79.   ──────────────--· ·   ·
  80.   ■ INSTALLATION
  81.   ──────────────--· ·   ·
  82.  
  83.   Hmm... copy it to your UTILS\ or WHATEVERITISCALLED\ subdirectory,
  84.   preferably in your PATH...
  85.  
  86.  
  87.  
  88.   ────────────--· ·   ·
  89.   ■ USING PPLX
  90.   ────────────--· ·   ·
  91.  
  92.   Type PPLX FILENAME[.PPE] [/DEBUG]
  93.  
  94.   /DEBUG was only intended for debugging purposes... Using this switch
  95.   will give you some iinformations on the current decompiling process,
  96.   completly UNusefull unless you found a PPE that does not decompile and
  97.   you want to mail me some informations...
  98.  
  99.  
  100.      WARNINGS/ERRORS
  101.  
  102.  
  103.     "Function is declared but not defined, code may not recompile..."
  104.  
  105.   This means that, in the original source code, a function was coded but not
  106.   used. When PPLC compile the source, if a function is not used, it doesn't
  107.   update a important field that holds the function coordinates... In this
  108.   case, PPLX will not be able to detect the beginning of the function, and,
  109.   if there are local variables, to declare them. The same problem may appear
  110.   with procedures.
  111.  
  112.  
  113.     "Unknown statement xxxx, dunno how to handle it... Skipping!"
  114.  
  115.   This means that an unknown stateemnt was used, theorically, this cannot
  116.   happen, but in real life, a corrupted PPE or a anti-decompilation trick
  117.   can produce this warning. If an unknown stateemnt is found, it is skipped,
  118.   causing some next statements to be irrationnal... Code may redecompile
  119.   correctly after some instructions but it is not likely that the code will
  120.   be recompilable.
  121.  
  122.  
  123.     "Unknown function xxxx, dunno how to handle it... Aborting!"
  124.  
  125.   This is a fatal error, an unknown function cannot be skipped, it is due
  126.   to the same things (corrupted PPE, anti-decompialtion trick) but cannot
  127.   recover.
  128.  
  129.  
  130.     "FATAL ERROR! ..."
  131.  
  132.   Any error message beginning by "FATAL ERROR" means that the PPE cannot be
  133.   decompiled due to different reasons... following message may not be clear
  134.   for you but if you write me a mail about the error, tell the PPE name,
  135.   and the error message.
  136.  
  137.  
  138.     FOR/NEXT/WHILE/IF/THEN/CASE/...
  139.  
  140.   Don't be surprised by a strange line of code, for example "If (1 < 0)" is
  141.   often used to initiate a FOR/NEXT loop... This is due to PPLC that convert
  142.   all loops to IF/GOTO... That's lame, yes, but that's the way it is... :(
  143.  
  144.  
  145.     BACKDOORS
  146.  
  147.   Don't be shy ;) Decompile all your PPE's, and check the statements/functions
  148.   usage report, a GetAltUser in a JOIN replacement may be strange ;)
  149.  
  150.  
  151.     PPE'S RUNNING DIFFERENT AFTER BEEING DECOMPILED & RECOMPILED
  152.  
  153.   Some PPE's (CSSC for example) compute a self check to see if they were
  154.   decompiled and recompiled... It is not a big deal because you have the
  155.   source so you can remove the self-check test.
  156.  
  157.  
  158.  
  159.   ───────────────────────--· ·   ·
  160.   ■ WARNINGz / DISCLAIMER
  161.   ───────────────────────--· ·   ·
  162.  
  163.  
  164.   ■ This decompiler should work perfectly on your machine as it is the
  165.     case on mine. However, some PPE may not decompile, due to some new
  166.     anti-decompilation tricks that maybe will cause PPLX to crash... It is
  167.     possible, also, that PPLX crash or fail to decompile a PPE because of a
  168.     special instruction chain that i didn't manage to handle... In such a
  169.     case, please mail me a description of the error and the name of the PPE
  170.     that failed to decompile...
  171.  
  172.   ■ Do what you want with this... You may use this program in any way you
  173.     want, you may destroy it, burn it, eat it, smoke it, inject it, vomit it,
  174.     kick it, suck it, piss it, shot it, print it with reversed lines, rename
  175.     it to zip, arj, arc or whatever you want, try then to extract it, to
  176.     pkzipfix it, you may also perform sort on it, uuencode, crypt it with
  177.     PGP, play it on your GUS or even your SB, you may even decompile, modify
  178.     it, you may do WHAT YOU WANT, but NO MEMBER OF AEGiS CoRP MAY BE
  179.     RESPONSIBLE FOR ANY DAMAGE CAUSED BY THE USE OF THIS PROGRAM OR IT'S
  180.     MODIFICATIONS...
  181.  
  182.  
  183.  
  184.   ─────────────--· ·   ·
  185.   ■ FINAL WORDS
  186.   ─────────────--· ·   ·
  187.  
  188.  
  189.  ■ Chicken/ECR
  190.  
  191.    Hi man ! Thanks to you for your eXXXcellent PPLD, even if we are still
  192.    waiting for the function/procedures support ;) Anyway, this was an gr8
  193.    program... We hope that you will like this one and that you will take
  194.    this maybe as a competition for the best decompiling code ;) Well, if
  195.    you want to discuss about PPE (de)compilation/(de)crypting, feel free
  196.    to contact me at the adress bellow, i would love this!
  197.  
  198.  
  199.  ■ Clark Development Company
  200.  
  201.    C'mon men, smile... decompiling a PPE was not a so big deal... it took
  202.    me 'bout 1 hour to make a decrypting system... the decompilation engine
  203.    took about 1 week to be operationnal... I remember something said in
  204.    a well known magazine : "PPE 3.x are more secure than EXE files...I doubt
  205.    that we will see one day a decompilation program for the new PPE format"
  206.    Well, see, there are now two of those decompilation programs out there...
  207.    Stop crypting, stop adding new tricks into the decompilation procedure,
  208.    stop changing small details that crash our decompilers... Remember that,
  209.    even if we (Chicken and me) are stopped by a new trick, there will always
  210.    be someone to defeat you... simply because your PPE need to be decrypted
  211.    by PCB itself... so you have no other choice that let a way to decrypt
  212.    them...
  213.  
  214.    You want a suggestion ? Make a real compiler that generate OBJ code...
  215.  
  216.  
  217.  ■ Shareware PPE Coders
  218.  
  219.    Well, sorry men, I also make PPE's, and very large ones that take many
  220.    months of programming, but asking money for such pieces of crap is lame... 
  221.  
  222.  
  223.  ■ PCB Sysops
  224.  
  225.    Well, you wanted a decompiler that works with functions & procedures...
  226.    now you have it ! Just hope it works on the special PPE you wanted
  227.    to decompile since 8 months ;)
  228.    I don't care that you will decompile and modify code, simply note that
  229.    decompiling and changing a program may be good (debugging, customization,
  230.    removing delays ;) , ... ) but, never, i said NEVER, change a copyright
  231.    notice... We have seen too many sysops changing PPE's authors name and
  232.    doing such lame operations... respect the work of a good coder... don't
  233.    be lame, let his name and notices...
  234.  
  235.  
  236.  ■ Lamers
  237.  
  238.    Ok, with this you will put backdoors and make new releases of PPE's...
  239.    I don't care... simply because if you can put a backdoor, we can also
  240.    decompile all PPE's that are about to be installed on our systems and
  241.    have a total control over the code... so don't bother, go to hell
  242.    immediatly, don't wait to die... thanks.
  243.  
  244.  
  245.  ■ Everybody
  246.  
  247.    Suggestions ? Contacts ? (legal only)
  248.  
  249.    Write to : lone.runner#dln@sparkhq.fdn.org
  250.  
  251.  
  252.  
  253.   ────────--· ·   ·
  254.   ■ GREETS
  255.   ────────--· ·   ·
  256.  
  257.  
  258.    The doC/AEGiS                - Thanks for your support in brainstormings
  259.                                   while trying to guess how was coded this
  260.                                   stupid PPE format ;)
  261.  
  262.    Gandalf/Infiny-AEGiS         - Still on this F*cking Windows proggy he? ;)
  263.  
  264.    Number Six/AEGiS             - So, i managed to decompile 100% of your
  265.                                   PPE's ;) do you have some more ? :)
  266.  
  267.    New ID/Massive Posse         - Ragga rulez!
  268.  
  269.    Jason Bourne/AEGiS           - Legalize !!!
  270.  
  271.    Ferem Destroy/MWB            - Did you finish you realtime-gouraud-shaded-
  272.                                   fractal-landscape-with-integrated-phong-
  273.                                   and-mutating-multitasking-code-impossible-
  274.                                   to-trace ? :))
  275.  
  276.    Kloy / (┤RT                  - Thanks for those kewl ASCIIz!
  277.  
  278.    HACKTiON                     - your are kewl guyz, make more prods!
  279.  
  280.    PWA                          - Is the PPE section still alive ? Hope so...
  281.                                   anyway, thanks to you guys, to have made
  282.                                   the world of PPE's so competitive...
  283.  
  284.    All (good ;)) PPE Groups     - Go on, continue to release new products,
  285.                                   and feel free to chat with AEGiS members,
  286.                                   write to aegis.corp#dln@sparkhq.fdn.org !
  287.                                  
  288.                                                                 
  289.                                                            _.LoNE RuNNeR
  290.  
  291.  
  292.                                         _    _  _ ___ ___/\
  293.     _________/\  /\_____________/\________________ ___ _  _ \/\______________
  294.    /      _    \/   _________  /    ______________________  /   __________  /
  295.  _/     __/     \    ____)___\/     \         \_/         \/\___________  \/_
  296.  \      \        \_  \        \_     \__       \_            \_        /    /
  297.   \______\        /____________/________________/_____________/____________/kP
  298.   ·-------`------'---------------------------------------------------------·
  299.  
  300.  
  301.  
  302.